@sayknow-cli/coding-agent 0.7.10 → 0.7.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (425) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/dist/types/async/result-formatting.d.ts +2 -0
  3. package/dist/types/capability/fs.d.ts +22 -3
  4. package/dist/types/capability/mcp.d.ts +2 -0
  5. package/dist/types/cli/append-system-prompt.d.ts +6 -0
  6. package/dist/types/cli/update-cli.d.ts +3 -0
  7. package/dist/types/commands/contribution-prep.d.ts +0 -3
  8. package/dist/types/commands/migrate.d.ts +1 -1
  9. package/dist/types/commands/sdk.d.ts +9 -0
  10. package/dist/types/commit/changelog/index.d.ts +1 -0
  11. package/dist/types/config/settings-schema.d.ts +14 -0
  12. package/dist/types/config/settings.d.ts +7 -1
  13. package/dist/types/coordinator-mcp/session-reaper.d.ts +5 -0
  14. package/dist/types/cursor-delete-path.d.ts +1 -0
  15. package/dist/types/cursor-mcp-name.d.ts +8 -0
  16. package/dist/types/dap/config.d.ts +8 -4
  17. package/dist/types/dap/session.d.ts +11 -2
  18. package/dist/types/debug/report-bundle-parent.d.ts +2 -0
  19. package/dist/types/debug/system-info.d.ts +6 -1
  20. package/dist/types/discovery/helpers.d.ts +11 -3
  21. package/dist/types/discovery/mcp-json.d.ts +1 -0
  22. package/dist/types/edit/file-read-cache.d.ts +4 -0
  23. package/dist/types/edit/modes/patch.d.ts +14 -0
  24. package/dist/types/edit/modes/replace.d.ts +8 -0
  25. package/dist/types/eval/py/runtime.d.ts +9 -0
  26. package/dist/types/exa/mcp-client.d.ts +11 -6
  27. package/dist/types/exec/bash-executor.d.ts +18 -1
  28. package/dist/types/export/html/css-color.d.ts +2 -0
  29. package/dist/types/export/html/html-export-destination.d.ts +2 -0
  30. package/dist/types/export/html/template.generated.d.ts +1 -1
  31. package/dist/types/extensibility/custom-tools/loader.d.ts +3 -2
  32. package/dist/types/extensibility/custom-tools/types.d.ts +3 -1
  33. package/dist/types/extensibility/plugins/marketplace/cache.d.ts +2 -0
  34. package/dist/types/extensibility/plugins/plugin-link-path.d.ts +2 -0
  35. package/dist/types/goals/runtime.d.ts +6 -0
  36. package/dist/types/harness-control-plane/receipt-spool.d.ts +4 -0
  37. package/dist/types/hindsight/content.d.ts +5 -6
  38. package/dist/types/internal-urls/skill-path.d.ts +1 -0
  39. package/dist/types/internal-urls/types.d.ts +2 -0
  40. package/dist/types/lsp/clients/swiftlint-client.d.ts +0 -4
  41. package/dist/types/lsp/config.d.ts +8 -5
  42. package/dist/types/lsp/workspace-path.d.ts +1 -0
  43. package/dist/types/migrate/adapters/codex.d.ts +2 -1
  44. package/dist/types/migrate/adapters/index.d.ts +10 -1
  45. package/dist/types/migrate/executor.d.ts +3 -1
  46. package/dist/types/migrate/types.d.ts +15 -3
  47. package/dist/types/modes/components/custom-editor.d.ts +6 -0
  48. package/dist/types/modes/components/extensions/state-manager.d.ts +4 -3
  49. package/dist/types/modes/components/model-selector.d.ts +46 -0
  50. package/dist/types/modes/controllers/input-controller.d.ts +9 -0
  51. package/dist/types/modes/interactive-mode.d.ts +1 -0
  52. package/dist/types/modes/utils/macos-option-forwarding.d.ts +17 -0
  53. package/dist/types/runtime-mcp/content-limits.d.ts +4 -0
  54. package/dist/types/runtime-mcp/manager.d.ts +9 -1
  55. package/dist/types/runtime-mcp/mcp-redirect.d.ts +9 -0
  56. package/dist/types/runtime-mcp/oauth-public-url.d.ts +1 -0
  57. package/dist/types/runtime-mcp/plugin-mcp-name-filter.d.ts +22 -0
  58. package/dist/types/runtime-mcp/plugin-network-boundary.d.ts +1 -0
  59. package/dist/types/runtime-mcp/project-host-values.d.ts +33 -0
  60. package/dist/types/runtime-mcp/smithery-registry.d.ts +24 -0
  61. package/dist/types/runtime-mcp/tool-bridge.d.ts +4 -0
  62. package/dist/types/runtime-mcp/types.d.ts +6 -0
  63. package/dist/types/sdk/broker/ensure.d.ts +2 -0
  64. package/dist/types/sdk/broker/lifecycle-ledger.d.ts +5 -1
  65. package/dist/types/sdk/broker/runtime.d.ts +1 -1
  66. package/dist/types/sdk/bus/chat-daemon-control.d.ts +3 -1
  67. package/dist/types/sdk/bus/telegram-daemon-contract.d.ts +3 -1
  68. package/dist/types/sdk/bus/telegram-daemon.d.ts +1 -0
  69. package/dist/types/sdk/host/events.d.ts +4 -0
  70. package/dist/types/session/agent-session.d.ts +20 -1
  71. package/dist/types/session/messages.d.ts +5 -1
  72. package/dist/types/session/session-manager.d.ts +13 -0
  73. package/dist/types/session/session-storage.d.ts +8 -0
  74. package/dist/types/session/streaming-output.d.ts +11 -0
  75. package/dist/types/session-import/redact.d.ts +1 -1
  76. package/dist/types/skc-runtime/managed-owner-admission.d.ts +3 -0
  77. package/dist/types/skc-runtime/psmux-detect.d.ts +5 -4
  78. package/dist/types/skc-runtime/ralplan-runtime.d.ts +5 -0
  79. package/dist/types/skc-runtime/sidecar-bootstrap-env.d.ts +6 -0
  80. package/dist/types/skc-runtime/state-writer.d.ts +4 -1
  81. package/dist/types/skc-runtime/tmux-sessions.d.ts +24 -0
  82. package/dist/types/skc-runtime/ultragoal-runtime.d.ts +4 -0
  83. package/dist/types/skill-state/workflow-mutation-guard.d.ts +20 -1
  84. package/dist/types/slash-commands/helpers/mcp.d.ts +5 -0
  85. package/dist/types/ssh/ssh-executor.d.ts +3 -1
  86. package/dist/types/system-prompt.d.ts +5 -2
  87. package/dist/types/task/executor.d.ts +17 -3
  88. package/dist/types/task/isolation-dir.d.ts +26 -0
  89. package/dist/types/task/role-body.d.ts +11 -0
  90. package/dist/types/task/token-log-mode.test.d.ts +1 -0
  91. package/dist/types/tools/ask.d.ts +77 -254
  92. package/dist/types/tools/ast-edit-write-path.d.ts +23 -0
  93. package/dist/types/tools/atomic-file-write.d.ts +74 -0
  94. package/dist/types/tools/auto-generated-guard.d.ts +5 -2
  95. package/dist/types/tools/bash-allowed-prefixes.d.ts +16 -0
  96. package/dist/types/tools/bash-interactive.d.ts +2 -0
  97. package/dist/types/tools/bash-skill-urls.d.ts +5 -1
  98. package/dist/types/tools/bash.d.ts +1 -0
  99. package/dist/types/tools/browser/cdp-url.d.ts +2 -0
  100. package/dist/types/tools/browser/tab-worker.d.ts +2 -0
  101. package/dist/types/tools/debug.d.ts +2 -2
  102. package/dist/types/tools/explicit-artifact.d.ts +8 -0
  103. package/dist/types/tools/fetch.d.ts +7 -4
  104. package/dist/types/tools/github-side-effect.d.ts +22 -0
  105. package/dist/types/tools/index.d.ts +3 -0
  106. package/dist/types/tools/monitor-mutation.d.ts +9 -0
  107. package/dist/types/tools/recipe/index.d.ts +2 -0
  108. package/dist/types/tools/recipe/recipe-guard.d.ts +7 -0
  109. package/dist/types/tools/restricted-cwd.d.ts +1 -0
  110. package/dist/types/tools/reverse-engineer.d.ts +81 -0
  111. package/dist/types/tools/search-tool-bm25.d.ts +2 -0
  112. package/dist/types/tools/tmux-self-injection-guard.d.ts +17 -0
  113. package/dist/types/tools/untrusted-content.d.ts +12 -0
  114. package/dist/types/utils/file-mentions.d.ts +5 -0
  115. package/dist/types/utils/open.d.ts +0 -1
  116. package/dist/types/utils/shell-snapshot.d.ts +2 -0
  117. package/dist/types/utils/title-generator.d.ts +12 -2
  118. package/dist/types/utils/tools-checksum.d.ts +7 -0
  119. package/dist/types/utils/xml-escape.d.ts +2 -0
  120. package/dist/types/web/scrapers/types.d.ts +8 -1
  121. package/dist/types/web/search/providers/codex.d.ts +6 -7
  122. package/dist/types/web/search/providers/insane.d.ts +7 -1
  123. package/dist/types/web/search/providers/kimi.d.ts +2 -0
  124. package/dist/types/web/search/providers/searxng.d.ts +7 -0
  125. package/dist/types/web/search/providers/xai.d.ts +2 -0
  126. package/package.json +7 -7
  127. package/scripts/generate-sdk-operation-inventory.ts +4 -0
  128. package/src/async/job-manager.ts +23 -9
  129. package/src/async/result-formatting.ts +40 -0
  130. package/src/capability/fs.ts +78 -11
  131. package/src/capability/mcp.ts +2 -0
  132. package/src/cli/append-system-prompt.ts +12 -0
  133. package/src/cli/auth-broker-cli.ts +22 -12
  134. package/src/cli/config-cli.ts +8 -18
  135. package/src/cli/migrate-cli.ts +7 -5
  136. package/src/cli/ssh-cli.ts +6 -3
  137. package/src/cli/stats-cli.ts +9 -4
  138. package/src/cli/update-cli.ts +42 -0
  139. package/src/cli/web-search-cli.ts +9 -3
  140. package/src/cli.ts +5 -9
  141. package/src/commands/commit.ts +2 -2
  142. package/src/commands/contribution-prep.ts +1 -3
  143. package/src/commands/harness.ts +25 -15
  144. package/src/commands/launch.ts +1 -1
  145. package/src/commands/migrate.ts +3 -3
  146. package/src/commands/sdk.ts +115 -14
  147. package/src/commands/ultragoal.ts +14 -8
  148. package/src/commit/agentic/agent.ts +6 -6
  149. package/src/commit/analysis/conventional.ts +14 -5
  150. package/src/commit/changelog/index.ts +39 -1
  151. package/src/commit/message.ts +10 -3
  152. package/src/config/config-file.ts +106 -3
  153. package/src/config/keybindings.ts +154 -7
  154. package/src/config/mcp-schema.json +4 -0
  155. package/src/config/model-registry.ts +10 -2
  156. package/src/config/settings-schema.ts +18 -0
  157. package/src/config/settings.ts +32 -4
  158. package/src/coordinator-mcp/policy.ts +14 -4
  159. package/src/coordinator-mcp/server.ts +44 -4
  160. package/src/coordinator-mcp/session-reaper.ts +9 -1
  161. package/src/cursor-delete-path.ts +10 -0
  162. package/src/cursor-mcp-name.ts +15 -0
  163. package/src/cursor.ts +13 -2
  164. package/src/dap/client.ts +9 -2
  165. package/src/dap/config.ts +33 -13
  166. package/src/dap/defaults.json +1 -1
  167. package/src/dap/session.ts +161 -36
  168. package/src/debug/crash-diagnostics.ts +89 -6
  169. package/src/debug/report-bundle-parent.ts +22 -0
  170. package/src/debug/report-bundle.ts +100 -3
  171. package/src/debug/system-info.ts +21 -4
  172. package/src/defaults/skc/extensions/grok-cli-vendor/src/shared/base-url.ts +21 -7
  173. package/src/defaults/skc/skills/deep-interview/SKILL.md +1 -1
  174. package/src/discovery/agents-md.ts +3 -2
  175. package/src/discovery/agents.ts +3 -2
  176. package/src/discovery/builtin.ts +21 -11
  177. package/src/discovery/claude.ts +5 -4
  178. package/src/discovery/cline.ts +2 -2
  179. package/src/discovery/codex.ts +6 -5
  180. package/src/discovery/cursor.ts +11 -2
  181. package/src/discovery/gemini.ts +4 -3
  182. package/src/discovery/github.ts +2 -2
  183. package/src/discovery/helpers.ts +51 -11
  184. package/src/discovery/mcp-json.ts +28 -12
  185. package/src/discovery/opencode.ts +2 -1
  186. package/src/discovery/ssh.ts +11 -6
  187. package/src/discovery/substitute-plugin-root.ts +3 -1
  188. package/src/discovery/vscode.ts +3 -3
  189. package/src/edit/apply-patch/index.ts +12 -1
  190. package/src/edit/file-read-cache.ts +24 -6
  191. package/src/edit/index.ts +90 -20
  192. package/src/edit/modes/patch.ts +215 -9
  193. package/src/edit/modes/replace.ts +141 -0
  194. package/src/eval/js/context-manager.ts +29 -3
  195. package/src/eval/js/worker-entry.ts +51 -18
  196. package/src/eval/py/runner.py +144 -5
  197. package/src/eval/py/runtime.ts +44 -4
  198. package/src/eval/py/tool-bridge.ts +4 -0
  199. package/src/exa/mcp-client.ts +53 -11
  200. package/src/exec/bash-executor.ts +87 -4
  201. package/src/exec/non-interactive-env.ts +0 -1
  202. package/src/export/html/css-color.ts +9 -0
  203. package/src/export/html/html-export-destination.ts +16 -0
  204. package/src/export/html/index.ts +102 -8
  205. package/src/export/html/template.generated.ts +1 -1
  206. package/src/extensibility/custom-tools/loader.ts +13 -3
  207. package/src/extensibility/custom-tools/types.ts +3 -1
  208. package/src/extensibility/custom-tools/wrapper.ts +3 -1
  209. package/src/extensibility/plugins/manager.ts +3 -2
  210. package/src/extensibility/plugins/marketplace/cache.ts +15 -0
  211. package/src/extensibility/plugins/marketplace/fetcher.ts +2 -2
  212. package/src/extensibility/plugins/marketplace/manager.ts +5 -3
  213. package/src/extensibility/plugins/plugin-link-path.ts +12 -0
  214. package/src/extensibility/skc-plugins/mcp-policy.ts +2 -1
  215. package/src/goals/runtime.ts +30 -8
  216. package/src/harness-control-plane/finalize.ts +10 -0
  217. package/src/harness-control-plane/operate.ts +12 -4
  218. package/src/harness-control-plane/owner.ts +8 -1
  219. package/src/harness-control-plane/receipt-spool.ts +105 -28
  220. package/src/harness-control-plane/storage.ts +124 -6
  221. package/src/hashline/execute.ts +3 -3
  222. package/src/hashline/recovery.ts +85 -2
  223. package/src/hindsight/config.ts +9 -3
  224. package/src/hindsight/content.ts +116 -16
  225. package/src/hindsight/mental-models.ts +22 -10
  226. package/src/hindsight/state.ts +7 -4
  227. package/src/hooks/native-skill-hook.ts +17 -12
  228. package/src/i18n/messages/de.settings.ts +3 -0
  229. package/src/i18n/messages/es.settings.ts +3 -0
  230. package/src/i18n/messages/fr.settings.ts +3 -0
  231. package/src/i18n/messages/ja.settings.ts +3 -0
  232. package/src/i18n/messages/ko.settings.ts +3 -0
  233. package/src/i18n/messages/zh.settings.ts +3 -0
  234. package/src/internal-urls/artifact-protocol.ts +3 -1
  235. package/src/internal-urls/docs-index.generated.ts +10 -10
  236. package/src/internal-urls/local-protocol.ts +167 -8
  237. package/src/internal-urls/skill-path.ts +18 -0
  238. package/src/internal-urls/skill-protocol.ts +2 -0
  239. package/src/internal-urls/types.ts +2 -0
  240. package/src/lsp/client.ts +2 -1
  241. package/src/lsp/clients/biome-client.ts +2 -0
  242. package/src/lsp/clients/swiftlint-client.ts +2 -0
  243. package/src/lsp/config.ts +18 -62
  244. package/src/lsp/edits.ts +6 -0
  245. package/src/lsp/index.ts +29 -0
  246. package/src/lsp/workspace-path.ts +75 -0
  247. package/src/main.ts +33 -11
  248. package/src/memories/index.ts +141 -9
  249. package/src/migrate/action-planner.ts +57 -0
  250. package/src/migrate/adapters/claude-code.ts +23 -4
  251. package/src/migrate/adapters/codex.ts +22 -4
  252. package/src/migrate/adapters/index.ts +22 -4
  253. package/src/migrate/adapters/opencode.ts +6 -1
  254. package/src/migrate/executor.ts +84 -7
  255. package/src/migrate/report.ts +19 -2
  256. package/src/migrate/types.ts +14 -4
  257. package/src/modes/DESIGN.md +5 -0
  258. package/src/modes/acp/acp-agent.ts +35 -2
  259. package/src/modes/acp/permission-mode.ts +18 -1
  260. package/src/modes/components/custom-editor.ts +14 -0
  261. package/src/modes/components/extensions/extension-dashboard.ts +2 -2
  262. package/src/modes/components/extensions/inspector-panel.ts +9 -5
  263. package/src/modes/components/extensions/state-manager.ts +15 -5
  264. package/src/modes/components/model-selector.ts +144 -94
  265. package/src/modes/components/welcome.ts +3 -2
  266. package/src/modes/controllers/command-controller.ts +300 -9
  267. package/src/modes/controllers/event-controller.ts +1 -1
  268. package/src/modes/controllers/extension-ui-controller.ts +32 -19
  269. package/src/modes/controllers/input-controller.ts +62 -26
  270. package/src/modes/controllers/plan-mode-controller.ts +17 -7
  271. package/src/modes/controllers/runtime-mcp-command-controller.ts +25 -20
  272. package/src/modes/controllers/ssh-command-controller.ts +3 -1
  273. package/src/modes/interactive-mode.ts +10 -0
  274. package/src/modes/utils/macos-option-forwarding.ts +80 -0
  275. package/src/prompts/system/irc-incoming.md +3 -1
  276. package/src/prompts/system/project-prompt.md +19 -0
  277. package/src/prompts/system/system-prompt.md +3 -0
  278. package/src/prompts/tools/ask.md +2 -0
  279. package/src/prompts/tools/debug.md +1 -1
  280. package/src/prompts/tools/monitor.md +7 -5
  281. package/src/prompts/tools/reverse-engineer.md +29 -0
  282. package/src/runtime-credential-selector.ts +2 -2
  283. package/src/runtime-mcp/config-writer.ts +10 -6
  284. package/src/runtime-mcp/config.ts +1 -0
  285. package/src/runtime-mcp/content-limits.ts +7 -0
  286. package/src/runtime-mcp/json-rpc.ts +2 -1
  287. package/src/runtime-mcp/manager.ts +57 -9
  288. package/src/runtime-mcp/mcp-redirect.ts +73 -0
  289. package/src/runtime-mcp/oauth-flow.ts +43 -5
  290. package/src/runtime-mcp/oauth-public-url.ts +8 -0
  291. package/src/runtime-mcp/plugin-mcp-name-filter.ts +62 -0
  292. package/src/runtime-mcp/plugin-network-boundary.ts +4 -0
  293. package/src/runtime-mcp/project-host-values.ts +50 -0
  294. package/src/runtime-mcp/render.ts +16 -1
  295. package/src/runtime-mcp/smithery-registry.ts +22 -3
  296. package/src/runtime-mcp/tool-bridge.ts +194 -21
  297. package/src/runtime-mcp/transports/http.ts +4 -3
  298. package/src/runtime-mcp/transports/stdio.ts +2 -1
  299. package/src/runtime-mcp/types.ts +6 -0
  300. package/src/sdk/broker/broker.ts +11 -2
  301. package/src/sdk/broker/ensure.ts +131 -10
  302. package/src/sdk/broker/lifecycle-ledger.ts +18 -3
  303. package/src/sdk/broker/lifecycle.ts +21 -19
  304. package/src/sdk/broker/runtime.ts +1 -1
  305. package/src/sdk/bus/chat-daemon-cli.ts +38 -1
  306. package/src/sdk/bus/chat-daemon-control.ts +5 -3
  307. package/src/sdk/bus/index.ts +5 -3
  308. package/src/sdk/bus/lifecycle-control-runtime.ts +9 -2
  309. package/src/sdk/bus/session-control.ts +2 -0
  310. package/src/sdk/bus/slack-daemon.ts +8 -1
  311. package/src/sdk/bus/slack-live-provider.ts +3 -1
  312. package/src/sdk/bus/telegram-daemon-contract.ts +3 -1
  313. package/src/sdk/bus/telegram-daemon-control.ts +17 -12
  314. package/src/sdk/bus/telegram-daemon.ts +41 -1
  315. package/src/sdk/host/events.ts +67 -4
  316. package/src/sdk/mcp/server.ts +16 -3
  317. package/src/sdk/protocol/operation-inventory.generated.json +22 -0
  318. package/src/sdk/session.ts +18 -25
  319. package/src/secrets/obfuscator.ts +92 -12
  320. package/src/session/agent-session.ts +395 -79
  321. package/src/session/artifacts.ts +3 -1
  322. package/src/session/history-storage.ts +172 -8
  323. package/src/session/internal/managed-session-scope.ts +130 -52
  324. package/src/session/messages.ts +47 -6
  325. package/src/session/session-manager.ts +170 -10
  326. package/src/session/session-storage.ts +31 -1
  327. package/src/session/streaming-output.ts +263 -4
  328. package/src/session-import/redact.ts +76 -3
  329. package/src/setup/hermes-setup.ts +4 -1
  330. package/src/skc-runtime/gc-runtime.ts +26 -4
  331. package/src/skc-runtime/launch-tmux.ts +21 -11
  332. package/src/skc-runtime/launch-worktree.ts +42 -3
  333. package/src/skc-runtime/managed-owner-admission.ts +46 -2
  334. package/src/skc-runtime/psmux-detect.ts +29 -5
  335. package/src/skc-runtime/ralplan-runtime.ts +14 -1
  336. package/src/skc-runtime/session-resolution.ts +38 -6
  337. package/src/skc-runtime/sidecar-bootstrap-env.ts +19 -0
  338. package/src/skc-runtime/state-writer.ts +134 -16
  339. package/src/skc-runtime/tmux-sessions.ts +85 -4
  340. package/src/skc-runtime/ultragoal-change-set.ts +18 -2
  341. package/src/skc-runtime/ultragoal-guard.ts +9 -1
  342. package/src/skc-runtime/ultragoal-runtime.ts +26 -9
  343. package/src/skill-state/active-state.ts +13 -0
  344. package/src/skill-state/workflow-mutation-guard.ts +3297 -180
  345. package/src/slash-commands/builtin-registry.ts +14 -8
  346. package/src/slash-commands/helpers/mcp.ts +20 -7
  347. package/src/ssh/ssh-executor.ts +3 -1
  348. package/src/stt/recorder.ts +26 -9
  349. package/src/system-prompt.ts +65 -16
  350. package/src/task/commands.ts +3 -1
  351. package/src/task/executor.ts +52 -7
  352. package/src/task/index.ts +28 -0
  353. package/src/task/isolation-dir.ts +143 -0
  354. package/src/task/role-body.ts +84 -0
  355. package/src/task/token-log-mode.test.ts +162 -0
  356. package/src/task/token-log.ts +91 -2
  357. package/src/task/worktree.ts +16 -7
  358. package/src/tools/archive-reader.ts +653 -31
  359. package/src/tools/ask.ts +86 -14
  360. package/src/tools/ast-edit-write-path.ts +133 -0
  361. package/src/tools/ast-edit.ts +27 -1
  362. package/src/tools/ast-grep.ts +7 -2
  363. package/src/tools/atomic-file-write.ts +625 -0
  364. package/src/tools/auto-generated-guard.ts +28 -8
  365. package/src/tools/bash-allowed-prefixes.ts +225 -6
  366. package/src/tools/bash-interactive.ts +12 -0
  367. package/src/tools/bash-skill-urls.ts +113 -7
  368. package/src/tools/bash.ts +152 -20
  369. package/src/tools/browser/cdp-url.ts +18 -0
  370. package/src/tools/browser/tab-worker.ts +49 -14
  371. package/src/tools/browser.ts +25 -8
  372. package/src/tools/cron.ts +10 -1
  373. package/src/tools/debug.ts +16 -8
  374. package/src/tools/eval.ts +71 -34
  375. package/src/tools/explicit-artifact.ts +89 -0
  376. package/src/tools/fetch.ts +26 -17
  377. package/src/tools/gh.ts +40 -12
  378. package/src/tools/github-side-effect.ts +112 -0
  379. package/src/tools/image-gen.ts +24 -10
  380. package/src/tools/index.ts +6 -0
  381. package/src/tools/monitor-mutation.ts +27 -0
  382. package/src/tools/monitor.ts +28 -1
  383. package/src/tools/output-meta.ts +74 -5
  384. package/src/tools/read.ts +24 -36
  385. package/src/tools/recipe/index.ts +12 -0
  386. package/src/tools/recipe/recipe-guard.ts +19 -0
  387. package/src/tools/recipe/runner.ts +23 -12
  388. package/src/tools/render-utils.ts +2 -2
  389. package/src/tools/restricted-cwd.ts +10 -0
  390. package/src/tools/reverse-engineer.ts +497 -0
  391. package/src/tools/search-tool-bm25.ts +14 -3
  392. package/src/tools/search.ts +3 -2
  393. package/src/tools/ssh.ts +235 -8
  394. package/src/tools/subagent-render.ts +43 -7
  395. package/src/tools/subagent.ts +7 -3
  396. package/src/tools/tmux-self-injection-guard.ts +3538 -0
  397. package/src/tools/todo-write.ts +41 -3
  398. package/src/tools/untrusted-content.ts +23 -0
  399. package/src/tools/vim.ts +2 -2
  400. package/src/tools/write.ts +37 -4
  401. package/src/tui/tree-list.ts +15 -1
  402. package/src/utils/commit-message-generator.ts +9 -2
  403. package/src/utils/external-editor.ts +21 -7
  404. package/src/utils/file-mentions.ts +75 -7
  405. package/src/utils/git.ts +38 -7
  406. package/src/utils/open.ts +73 -4
  407. package/src/utils/shell-snapshot.ts +9 -1
  408. package/src/utils/title-generator.ts +61 -16
  409. package/src/utils/tools-checksum.ts +34 -0
  410. package/src/utils/tools-manager.ts +24 -6
  411. package/src/utils/xml-escape.ts +14 -0
  412. package/src/web/insane/url-guard.ts +2 -1
  413. package/src/web/scrapers/types.ts +8 -0
  414. package/src/web/scrapers/youtube.ts +3 -2
  415. package/src/web/search/index.ts +4 -3
  416. package/src/web/search/providers/anthropic.ts +4 -4
  417. package/src/web/search/providers/codex.ts +31 -34
  418. package/src/web/search/providers/insane.ts +145 -28
  419. package/src/web/search/providers/kimi.ts +15 -5
  420. package/src/web/search/providers/searxng.ts +47 -4
  421. package/src/web/search/providers/xai.ts +7 -2
  422. package/dist/types/cli/shell-cli.d.ts +0 -8
  423. package/dist/types/commands/shell.d.ts +0 -21
  424. package/src/cli/shell-cli.ts +0 -176
  425. package/src/commands/shell.ts +0 -29
package/CHANGELOG.md CHANGED
@@ -2,6 +2,24 @@
2
2
 
3
3
  ## [Unreleased]
4
4
 
5
+ ## [0.7.12] - 2026-10-24
6
+
7
+ ### Added
8
+
9
+ - `reverse_engineer` tool: when you give a link, app, or binary and ask SKC to build one like it ("make this", "참고해서 만들어줘", "똑같이 만들어줘"), the agent inspects the shipped product with [REA](https://github.com/morluto/rea) (`rea-agents@6.7.0`, run through npx/bunx on first use) and builds from the evidence. The tool is hidden until such a request and is not used otherwise. Commands that change the host or a device, open debugger consoles, or drive the user's running apps are not exposed. Disable it with `reverseEngineer.enabled: false`.
10
+
11
+ ### Fixed
12
+
13
+ - `search_tool_bm25` no longer reports an empty result when the matching tool is already active. It lists such tools in `already_active_tools`, so the model uses the tool instead of concluding it is unavailable.
14
+
15
+ ## [0.7.11] - 2026-10-22
16
+
17
+ ### Fixed
18
+
19
+ - Signed `thinking` and `redactedThinking` blocks stay inline in the session instead of being moved to the resident text cache. A lost cache file was replaced with placeholder text under the original signature, and Anthropic then rejected every request with `Invalid signature in thinking block`. Sessions that already lost such a blob now drop that reasoning block (text and signature together) instead of replaying the placeholder.
20
+ - Auto-compaction no longer fails with `Missing resident text blob` when old history already lost a resident blob; the spilled copy records the missing-content placeholder, so compaction can still replace the damaged history.
21
+ - A failed `/fork` rolled back to entries that still pointed into the resident store the fork had just disposed, so every large string in the session became unreadable afterwards. The rollback now restores the materialized entries.
22
+
5
23
  ## [0.7.10] - 2026-10-20
6
24
 
7
25
  ### Added
@@ -0,0 +1,2 @@
1
+ import type { SessionManager } from "../session/session-manager";
2
+ export declare function formatAsyncResultForFollowUp(sessionManager: SessionManager, result: string, allowArtifact?: boolean): Promise<string>;
@@ -1,6 +1,24 @@
1
1
  import * as fs from "node:fs";
2
- export declare function readFile(filePath: string): Promise<string | null>;
3
- export declare function readDirEntries(dirPath: string): Promise<fs.Dirent[]>;
2
+ /** Authority a discovery read runs under. */
3
+ export type ReadScope = "project" | "user";
4
+ export interface ReadFileOptions {
5
+ readonly scope?: ReadScope;
6
+ /** Skip the shared lexical cache for this operation. */
7
+ readonly bypassCache?: boolean;
8
+ /**
9
+ * Physical root a target lexically inside it must stay inside after
10
+ * realpath, so a repository symlink cannot be read as its external target.
11
+ */
12
+ readonly containmentRoot?: string;
13
+ }
14
+ /**
15
+ * The real target a contained read refused: the path is lexically inside the
16
+ * containment root but resolves outside it. Null when the read was not refused
17
+ * for containment (no root, outside lexically, inside after realpath, missing).
18
+ */
19
+ export declare function containmentRefusalTarget(filePath: string, options?: ReadFileOptions): Promise<string | null>;
20
+ export declare function readFile(filePath: string, options?: ReadFileOptions): Promise<string | null>;
21
+ export declare function readDirEntries(dirPath: string, options?: Pick<ReadFileOptions, "bypassCache">): Promise<fs.Dirent[]>;
4
22
  export declare function readDir(dirPath: string): Promise<string[]>;
5
23
  export declare function walkUp(startDir: string, name: string, opts?: {
6
24
  file?: boolean;
@@ -9,7 +27,8 @@ export declare function walkUp(startDir: string, name: string, opts?: {
9
27
  /**
10
28
  * Walk up from startDir looking for a `.git` entry (file or directory).
11
29
  * Returns the directory containing `.git` (the repo root), or null if not in a git repo.
12
- * Results are based on the cached readDirEntries, so repeated calls are cheap.
30
+ * Reads bypass the directory cache: the repository root is the project read
31
+ * boundary, so a `.git` created after an earlier discovery must narrow it.
13
32
  */
14
33
  export declare function findRepoRoot(startDir: string): Promise<string | null>;
15
34
  export declare function cacheStats(): {
@@ -25,6 +25,8 @@ export interface MCPServer {
25
25
  url?: string;
26
26
  /** HTTP headers (for HTTP transport) */
27
27
  headers?: Record<string, string>;
28
+ /** Persisted public-network requirement for an HTTP MCP endpoint. */
29
+ publicNetwork?: boolean;
28
30
  /** Authentication configuration */
29
31
  auth?: {
30
32
  type: "oauth" | "apikey";
@@ -0,0 +1,6 @@
1
+ export interface AppendSystemPromptCandidate {
2
+ level: "user" | "project";
3
+ path: string;
4
+ }
5
+ /** First user file. A repository copy is untrusted project text and is never selected. */
6
+ export declare function selectAppendSystemPromptFile(candidates: readonly AppendSystemPromptCandidate[]): string | undefined;
@@ -54,6 +54,9 @@ export type UpdateTarget = {
54
54
  };
55
55
  type PathPlatform = NodeJS.Platform;
56
56
  type PackageExists = (packageName: string, packageRoot: string) => boolean;
57
+ export declare function resolveProjectLocalPackageInstallForTest(ompPath: string, platform: PathPlatform): {
58
+ packageRoot: string;
59
+ } | undefined;
57
60
  export declare function resolveUpdateMethodForTest(ompPath: string, bunBinDir: string | undefined): "bun" | "npm" | "binary";
58
61
  export declare function resolveNpmManagedTargetForTest(ompPath: string, platform: PathPlatform, packageExists: PackageExists): PackageManagerTarget | undefined;
59
62
  export declare function getBinaryNameForTest(platform?: NodeJS.Platform, arch?: string): string;
@@ -3,9 +3,6 @@ export default class ContributionPrep extends Command {
3
3
  static description: string;
4
4
  static strict: boolean;
5
5
  static flags: {
6
- "no-spawn": import("@sayknow-cli/utils/cli").FlagDescriptor<"boolean"> & {
7
- description: string;
8
- };
9
6
  "source-session-id": import("@sayknow-cli/utils/cli").FlagDescriptor<"string"> & {
10
7
  description: string;
11
8
  };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * Import MCP servers and skills from other coding agents into SKC.
2
+ * Import MCP servers, skills, and instructions from other coding agents into SKC.
3
3
  */
4
4
  import { Command } from "@sayknow-cli/utils/cli";
5
5
  export default class Migrate extends Command {
@@ -1,4 +1,5 @@
1
1
  import { Command } from "@sayknow-cli/utils/cli";
2
+ import { type ProjectEnvSnapshot } from "@sayknow-cli/utils/env-file";
2
3
  import type { Args as ParsedArgs } from "../cli/args";
3
4
  import { type SessionLifecycleLaunchRequest } from "../sdk/broker/lifecycle";
4
5
  import { SessionManager } from "../session/session-manager";
@@ -8,6 +9,11 @@ export declare function openLifecycleSessionManager(request: SessionLifecycleLau
8
9
  parsed: ParsedArgs;
9
10
  sessionManager: SessionManager | undefined;
10
11
  }>;
12
+ /**
13
+ * Cwd-equality test seams accept only an operator value. A project dotenv line,
14
+ * including one Bun expands from `$PWD`, never arms the seam.
15
+ */
16
+ export declare function sdkCwdEqualityTestSeamActive(name: string, cwd: string, env?: NodeJS.ProcessEnv, snapshots?: readonly ProjectEnvSnapshot[]): boolean;
11
17
  /** Runs the same persisted AgentSession bootstrap used by the production CLI. */
12
18
  export declare function runSessionHost(timing?: {
13
19
  now?: () => number;
@@ -18,6 +24,9 @@ export declare function runSessionHost(timing?: {
18
24
  export type SdkInternalArgv = {
19
25
  action: "broker-internal";
20
26
  agentDir: string;
27
+ } | {
28
+ action: "broker-trampoline-internal";
29
+ agentDir: string;
21
30
  } | {
22
31
  action: "session-host-internal";
23
32
  };
@@ -28,3 +28,4 @@ export declare function runChangelogFlow({ cwd, model, apiKey, thinkingLevel, st
28
28
  * Apply changelog entries provided by the commit agent.
29
29
  */
30
30
  export declare function applyChangelogProposals({ cwd, proposals, dryRun, onProgress, }: ChangelogProposalInput): Promise<string[]>;
31
+ export declare function redactChangelogEntry(text: string): string;
@@ -2999,6 +2999,10 @@ export declare const SETTINGS_SCHEMA: {
2999
2999
  readonly type: "string";
3000
3000
  readonly default: undefined;
3001
3001
  };
3002
+ readonly "shellMinimizer.settingsHash": {
3003
+ readonly type: "string";
3004
+ readonly default: undefined;
3005
+ };
3002
3006
  readonly "shellMinimizer.only": {
3003
3007
  readonly type: "array";
3004
3008
  readonly default: string[];
@@ -3285,6 +3289,15 @@ export declare const SETTINGS_SCHEMA: {
3285
3289
  readonly description: "Enable the gitlab tool (op-based dispatch for merge request create/view/list and pipeline status via glab)";
3286
3290
  };
3287
3291
  };
3292
+ readonly "reverseEngineer.enabled": {
3293
+ readonly type: "boolean";
3294
+ readonly default: true;
3295
+ readonly ui: {
3296
+ readonly tab: "tools";
3297
+ readonly label: "Reverse Engineer (REA)";
3298
+ readonly description: "Enable the reverse_engineer tool (REA via npx/bunx) for building something modeled on a user-supplied link, app, or binary";
3299
+ };
3300
+ };
3288
3301
  readonly "github.cache.enabled": {
3289
3302
  readonly type: "boolean";
3290
3303
  readonly default: true;
@@ -4841,6 +4854,7 @@ export interface BashInterceptorRule {
4841
4854
  export interface ShellMinimizerSettings {
4842
4855
  enabled: boolean;
4843
4856
  settingsPath: string | undefined;
4857
+ settingsHash: string | undefined;
4844
4858
  only: string[];
4845
4859
  except: string[];
4846
4860
  maxCaptureBytes: number;
@@ -114,6 +114,10 @@ export declare class Settings implements NotificationSettingsReader {
114
114
  * Apply runtime overrides (not persisted).
115
115
  */
116
116
  override<P extends SettingPath>(path: P, value: SettingValue<P>): void;
117
+ /**
118
+ * Get a runtime override value only (not persisted; excludes user and project files).
119
+ */
120
+ getOverride<P extends SettingPath>(path: P): SettingValue<P> | undefined;
117
121
  /**
118
122
  * Clear a runtime override.
119
123
  */
@@ -128,7 +132,9 @@ export declare class Settings implements NotificationSettingsReader {
128
132
  getAgentDir(): string;
129
133
  getPlansDirectory(): string;
130
134
  /**
131
- * Get shell configuration based on settings.
135
+ * Shell configuration for bash and the Python executor.
136
+ * `shellPath` comes from the user/global config only, so a project
137
+ * `.skc/settings.json` cannot select the binary those executors run.
132
138
  */
133
139
  getShellConfig(): procmgr.ShellConfig;
134
140
  /**
@@ -18,6 +18,11 @@ export declare const DEFAULT_SESSION_IDLE_TTL_MS: number;
18
18
  export declare const DEFAULT_SESSION_SWEEP_INTERVAL_MS: number;
19
19
  export declare const MIN_SESSION_IDLE_TTL_MS = 60000;
20
20
  export declare const MIN_SESSION_SWEEP_INTERVAL_MS = 30000;
21
+ /**
22
+ * Longest delay setTimeout honors. Bun, like Node, treats any larger delay as 1 ms,
23
+ * so an operator's very long sweep interval would otherwise re-sweep back to back.
24
+ */
25
+ export declare const MAX_SESSION_SWEEP_INTERVAL_MS: number;
21
26
  /** Minimal projection of a coordinator session the reaper needs to decide. */
22
27
  export interface ReapableSession {
23
28
  sessionId: string;
@@ -0,0 +1 @@
1
+ export declare function assertDeleteInsideWorkspace(cwd: string, filePath: string): Promise<void>;
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Name to dispatch from a Cursor MCP call.
3
+ * Dedicated-channel tools are refused here. Advertised session tools such as eval stay allowed.
4
+ */
5
+ export declare function cursorMcpDispatchName(call: {
6
+ toolName?: string;
7
+ name?: string;
8
+ }): string | null;
@@ -1,6 +1,10 @@
1
1
  import type { DapAdapterConfig, DapResolvedAdapter } from "./types";
2
2
  export declare function getAdapterConfigs(): Record<string, DapAdapterConfig>;
3
- export declare function resolveAdapter(adapterName: string, cwd: string): DapResolvedAdapter | null;
4
- export declare function getAvailableAdapters(cwd: string): DapResolvedAdapter[];
5
- export declare function selectLaunchAdapter(program: string, cwd: string, adapterName?: string): DapResolvedAdapter | null;
6
- export declare function selectAttachAdapter(cwd: string, adapterName?: string, port?: number): DapResolvedAdapter | null;
3
+ /**
4
+ * `trustCwds` are extra trust roots, such as the session workspace when the command
5
+ * cwd is a different directory. A command controlled by any of them is refused.
6
+ */
7
+ export declare function resolveAdapter(adapterName: string, cwd: string, trustCwds?: readonly string[]): DapResolvedAdapter | null;
8
+ export declare function getAvailableAdapters(cwd: string, trustCwds?: readonly string[]): DapResolvedAdapter[];
9
+ export declare function selectLaunchAdapter(program: string, cwd: string, adapterName?: string, trustCwds?: readonly string[]): DapResolvedAdapter | null;
10
+ export declare function selectAttachAdapter(cwd: string, adapterName?: string, port?: number, trustCwds?: readonly string[]): DapResolvedAdapter | null;
@@ -1,16 +1,25 @@
1
1
  import type { DapAttachSessionOptions, DapBreakpointRecord, DapCapabilities, DapContinueOutcome, DapDataBreakpointInfoResponse, DapDataBreakpointRecord, DapDisassembledInstruction, DapEvaluateArguments, DapEvaluateResponse, DapFunctionBreakpointRecord, DapInstructionBreakpointRecord, DapLaunchSessionOptions, DapModule, DapSessionSummary, DapSource, DapStackFrame, DapThread } from "./types";
2
+ /** Test seam: pauses after cwd containment and before the debuggee spawn. */
3
+ export declare const runInTerminalTestHooks: {
4
+ beforeSpawn?: () => Promise<void>;
5
+ };
2
6
  export interface DapOutputSnapshot {
3
7
  snapshot: DapSessionSummary;
4
8
  output: string;
5
9
  }
10
+ export declare function cwdEscapesWorkspace(root: string, candidate: string): boolean;
6
11
  export declare class DapSessionManager {
7
12
  #private;
8
13
  constructor();
9
14
  getActiveSession(): DapSessionSummary | null;
10
15
  listSessions(): DapSessionSummary[];
11
16
  getCapabilities(): DapCapabilities | null;
12
- launch(options: DapLaunchSessionOptions, signal?: AbortSignal, timeoutMs?: number): Promise<DapSessionSummary>;
13
- attach(options: DapAttachSessionOptions, signal?: AbortSignal, timeoutMs?: number): Promise<DapSessionSummary>;
17
+ launch(options: DapLaunchSessionOptions & {
18
+ workspace?: string;
19
+ }, signal?: AbortSignal, timeoutMs?: number): Promise<DapSessionSummary>;
20
+ attach(options: DapAttachSessionOptions & {
21
+ workspace?: string;
22
+ }, signal?: AbortSignal, timeoutMs?: number): Promise<DapSessionSummary>;
14
23
  setBreakpoint(file: string, line: number, condition?: string, signal?: AbortSignal, timeoutMs?: number): Promise<{
15
24
  snapshot: DapSessionSummary;
16
25
  breakpoints: DapBreakpointRecord[];
@@ -0,0 +1,2 @@
1
+ /** True when a session header names this parent file or its basename. */
2
+ export declare function sessionBelongsToParent(headerLine: string, parentBasename: string): boolean;
@@ -22,5 +22,10 @@ export interface SystemInfo {
22
22
  export declare function collectSystemInfo(): Promise<SystemInfo>;
23
23
  /** Format system info for display */
24
24
  export declare function formatSystemInfo(info: SystemInfo): string;
25
- /** Sanitize environment variables by redacting sensitive values */
25
+ /**
26
+ * Sanitize environment variables for a debug report.
27
+ * Sensitive names stay fully replaced. Other values keep their text, with the
28
+ * same credential shapes removed that crash records already scrub before they
29
+ * are written to disk.
30
+ */
26
31
  export declare function sanitizeEnv(env: Record<string, string | undefined>): Record<string, string>;
@@ -1,5 +1,6 @@
1
1
  import type { ThinkingLevel } from "@sayknow-cli/agent-core";
2
2
  import type { ExtensionModule } from "../capability/extension-module";
3
+ import { type ReadFileOptions, type ReadScope } from "../capability/fs";
3
4
  import { type Rule } from "../capability/rule";
4
5
  import type { Skill } from "../capability/skill";
5
6
  import type { LoadContext, LoadResult, SourceMeta } from "../capability/types";
@@ -68,6 +69,12 @@ export declare function getUserPath(ctx: LoadContext, source: SourceId, subpath:
68
69
  * Get project-level path for a source (cwd only).
69
70
  */
70
71
  export declare function getProjectPath(ctx: LoadContext, source: SourceId, subpath: string): string | null;
72
+ /**
73
+ * Filesystem authority for a provider read. Project reads are bounded by the
74
+ * repository (or the opened directory without one): a repository symlink to a
75
+ * file outside it must not be loaded into the prompt as its external target.
76
+ */
77
+ export declare function getReadOptions(ctx: Pick<LoadContext, "cwd" | "repoRoot">, scope: ReadScope): ReadFileOptions | undefined;
71
78
  /**
72
79
  * Create source metadata for an item.
73
80
  */
@@ -120,16 +127,17 @@ export interface ScanSkillsFromDirOptions {
120
127
  requireDescription?: boolean;
121
128
  }
122
129
  export declare function compareSkillOrder(aName: string, aPath: string, bName: string, bPath: string): number;
123
- export declare function scanSkillsFromDir(_ctx: LoadContext, options: ScanSkillsFromDirOptions): Promise<LoadResult<Skill>>;
130
+ export declare function scanSkillsFromDir(ctx: LoadContext, options: ScanSkillsFromDirOptions): Promise<LoadResult<Skill>>;
131
+ export declare function isSensitiveEnvName(name: string): boolean;
124
132
  /**
125
133
  * Recursively expand environment variables in an object.
126
134
  */
127
- export declare function expandEnvVarsDeep<T>(obj: T, extraEnv?: Record<string, string>): T;
135
+ export declare function expandEnvVarsDeep<T>(obj: T, extraEnv?: Record<string, string>, skipSensitiveNames?: boolean): T;
128
136
  /**
129
137
  * Load files from a directory matching extensions.
130
138
  * Uses native glob for fast filesystem scanning with gitignore support.
131
139
  */
132
- export declare function loadFilesFromDir<T>(_ctx: LoadContext, dir: string, provider: string, level: "user" | "project", options: {
140
+ export declare function loadFilesFromDir<T>(ctx: LoadContext, dir: string, provider: string, level: "user" | "project", options: {
133
141
  /** File extensions to match (without dot) */
134
142
  extensions?: string[];
135
143
  /** Transform file to item (return null to skip) */
@@ -9,4 +9,5 @@ export interface MCPJsonLoadResult extends LoadResult<MCPServer> {
9
9
  export declare function loadMCPJsonFile(filePath: string, level: "user" | "project", options?: {
10
10
  quiet?: boolean;
11
11
  useCache?: boolean;
12
+ skipSensitiveEnvNames?: boolean;
12
13
  }): Promise<MCPJsonLoadResult>;
@@ -2,6 +2,8 @@ import type { ToolSession } from "../tools";
2
2
  export interface FileReadSnapshot {
3
3
  /** 1-indexed line number → exact line content as observed by `read`/`search`. */
4
4
  lines: Map<number, string>;
5
+ /** Total line count when the snapshot is known to cover the whole file. */
6
+ lineCount?: number;
5
7
  recordedAt: number;
6
8
  }
7
9
  export declare class FileReadCache {
@@ -10,6 +12,8 @@ export declare class FileReadCache {
10
12
  get(absPath: string): FileReadSnapshot | null;
11
13
  /** Record a contiguous run of lines (e.g. from a `read` tool). `startLine` is 1-indexed. */
12
14
  recordContiguous(absPath: string, startLine: number, lines: readonly string[]): void;
15
+ /** Record the complete content of a file (e.g. the result of an edit this session wrote). */
16
+ recordFull(absPath: string, lines: readonly string[]): void;
13
17
  /** Record sparse `(lineNumber, content)` pairs (e.g. `search` matches plus context). */
14
18
  recordSparse(absPath: string, entries: Iterable<readonly [number, string]>): void;
15
19
  /** Drop the snapshot for a single path. */
@@ -6,6 +6,7 @@
6
6
  */
7
7
  import type { AgentToolResult } from "@sayknow-cli/agent-core";
8
8
  import * as z from "zod/v4";
9
+ import type { Settings } from "../../config/settings";
9
10
  import { type WritethroughCallback, type WritethroughDeferredHandle } from "../../lsp";
10
11
  import type { ToolSession } from "../../tools";
11
12
  import type { EditToolDetails, LspBatchRequest } from "../renderer";
@@ -50,6 +51,17 @@ export interface ApplyPatchOptions {
50
51
  * object identity is not a durable-lock capability probe.
51
52
  */
52
53
  crossProcessLock?: boolean;
54
+ /** Explicit artifacts `local` root for this call. The caller session owns it. */
55
+ localRoot?: string;
56
+ signal?: AbortSignal;
57
+ /**
58
+ * Recheck a rename destination while this call holds the path mutation lock.
59
+ * The request preflight runs before that lock.
60
+ */
61
+ destinationGuard?: {
62
+ settings: Pick<Settings, "get">;
63
+ displayPath: string;
64
+ };
53
65
  }
54
66
  /** Default filesystem implementation using Bun APIs */
55
67
  export declare const defaultFileSystem: FileSystem;
@@ -61,6 +73,8 @@ export declare const defaultFileSystem: FileSystem;
61
73
  * edits cannot silently overwrite each other (#2900).
62
74
  */
63
75
  export declare function applyPatch(input: PatchInput, options: ApplyPatchOptions): Promise<ApplyPatchResult>;
76
+ /** Read-only mkdir check for one patch hunk. Does not create directories. */
77
+ export declare function preflightPatchMkdir(input: PatchInput, options: ApplyPatchOptions): Promise<void>;
64
78
  /**
65
79
  * Preview what changes a patch would make without applying it.
66
80
  */
@@ -146,4 +146,12 @@ export interface ExecuteReplaceSingleOptions {
146
146
  beginDeferredDiagnosticsForPath: (path: string) => WritethroughDeferredHandle;
147
147
  }
148
148
  export declare function executeReplaceSingle(options: ExecuteReplaceSingleOptions): Promise<AgentToolResult<EditToolDetails, typeof replaceEditEntrySchema>>;
149
+ /**
150
+ * Apply every replacement for one path in memory and write once. A generated
151
+ * file (on disk or produced by an earlier entry) refuses the whole batch, so a
152
+ * later refusal never leaves earlier entries published.
153
+ */
154
+ export declare function executeReplaceEntries(options: Omit<ExecuteReplaceSingleOptions, "params"> & {
155
+ edits: ReplaceEditEntry[];
156
+ }): Promise<AgentToolResult<EditToolDetails, typeof replaceEditSchema>>;
149
157
  export {};
@@ -5,6 +5,15 @@ export interface PythonRuntimeOptions {
5
5
  /** Packages to seed into the managed workspace venv when provisioning it. */
6
6
  seedPackages?: readonly string[];
7
7
  }
8
+ /**
9
+ * A workspace `.venv` or `venv` directory is repository content. Use it only when
10
+ * it is a real virtualenv (`pyvenv.cfg`) whose interpreter file resolves outside
11
+ * the project. An in-tree script or binary is not an interpreter.
12
+ *
13
+ * True when `candidate` is `root` or a descendant after `path.resolve`.
14
+ * A name such as `..payload` stays inside. Only `..` and a parent segment escape.
15
+ */
16
+ export declare function workspacePathContained(root: string, candidate: string): boolean;
8
17
  export interface PythonRuntime {
9
18
  /** Path to python executable */
10
19
  pythonPath: string;
@@ -1,7 +1,16 @@
1
1
  import type { TSchema } from "@sayknow-cli/ai";
2
2
  import type { CustomTool, CustomToolResult } from "../extensibility/custom-tools/types";
3
3
  import type { ExaRenderDetails, ExaSearchResponse, MCPTool, MCPToolWrapperConfig } from "./types";
4
- /** Find EXA_API_KEY from Bun.env or .env files */
4
+ /**
5
+ * Find `EXA_API_KEY` from trusted environment sources.
6
+ *
7
+ * The key authenticates every Exa MCP call and travels in the request URL, so
8
+ * whatever can set it decides which account the agent's searches run through —
9
+ * and therefore who can see those queries. `$env` merges the caller's `cwd/.env`
10
+ * into `process.env`, so reading it there would let repository content supply
11
+ * that account. Resolve it the same way provider credentials are: launching
12
+ * shell plus SKC/user-owned `.env` files, never the project `.env`.
13
+ */
5
14
  export declare function findApiKey(): string | null;
6
15
  /** Fetch available tools from Exa MCP */
7
16
  export declare function fetchExaTools(apiKey: string | null, toolNames: string[]): Promise<MCPTool[]>;
@@ -13,11 +22,7 @@ export declare function callExaTool(toolName: string, args: Record<string, unkno
13
22
  export declare function callWebsetsTool(apiKey: string, toolName: string, args: Record<string, unknown>): Promise<unknown>;
14
23
  /** Format search results for LLM */
15
24
  export declare function formatSearchResults(data: ExaSearchResponse): string;
16
- /**
17
- * Format a non-search MCP response as human-readable text.
18
- * Handles objects, arrays, primitives, and common MCP response shapes.
19
- */
20
- export declare function formatGenericResponse(data: unknown): string;
25
+ export declare function formatGenericResponse(data: unknown, depth?: number): string;
21
26
  /** Check if result is a search response */
22
27
  export declare function isSearchResponse(data: unknown): data is ExaSearchResponse;
23
28
  /** Fetch and cache MCP tool schema */
@@ -1,5 +1,5 @@
1
1
  import { type MinimizerOptions } from "@sayknow-cli/natives";
2
- import { type ShellMinimizerSettings } from "../config/settings";
2
+ import { Settings, type ShellMinimizerSettings } from "../config/settings";
3
3
  export interface BashExecutorOptions {
4
4
  cwd?: string;
5
5
  timeout?: number | null;
@@ -12,10 +12,14 @@ export interface BashExecutorOptions {
12
12
  */
13
13
  onRawChunk?: (chunk: string) => void;
14
14
  signal?: AbortSignal;
15
+ /** Session settings used for shell policy; defaults to the process settings. */
16
+ settings?: Settings;
15
17
  /** Session key suffix to isolate shell sessions per agent */
16
18
  sessionKey?: string;
17
19
  /** Additional environment variables to inject */
18
20
  env?: Record<string, string>;
21
+ /** Environment variable names to remove for this command only. Explicit `env` values win. */
22
+ unsetEnv?: string[];
19
23
  /** Artifact path/id for full output storage */
20
24
  artifactPath?: string;
21
25
  artifactId?: string;
@@ -59,6 +63,19 @@ export declare function getShellSessionCount(): number;
59
63
  * shell resources, and is also callable directly (e.g. on owner teardown).
60
64
  */
61
65
  export declare function disposeAllShellSessions(): Promise<void>;
66
+ type ShellMinimizerSource = {
67
+ getGroup(prefix: "shellMinimizer"): ShellMinimizerSettings;
68
+ getGlobal?(path: "shellMinimizer.settingsPath" | "shellMinimizer.settingsHash"): unknown;
69
+ getOverride?(path: "shellMinimizer.settingsPath"): unknown;
70
+ };
71
+ /**
72
+ * A repo `.skc/settings.json` must not point the minimizer at a TOML file.
73
+ * The native gate loads that file only when `settingsHash` matches, and the
74
+ * pin is the user/global value. A user path or a runtime override is still
75
+ * passed through. A project path is passed only together with that pin.
76
+ */
77
+ export declare function resolveTrustedShellMinimizer(settings: ShellMinimizerSource): ShellMinimizerSettings;
62
78
  /** Translate `ShellMinimizerSettings` into native `MinimizerOptions`, or `undefined` when disabled. */
63
79
  export declare function buildMinimizerOptions(group: ShellMinimizerSettings): MinimizerOptions | undefined;
64
80
  export declare function executeBash(command: string, options?: BashExecutorOptions): Promise<BashResult>;
81
+ export {};
@@ -0,0 +1,2 @@
1
+ /** Keep a theme color that is safe to place in a `<style>` block. */
2
+ export declare function cssColorOrFallback(value: string | undefined, fallback: string): string;
@@ -0,0 +1,2 @@
1
+ /** Owner-only HTML export. A replaced file is locked down on the opened descriptor. */
2
+ export declare function openHtmlExportDestination(outputPath: string): number;